home *** CD-ROM | disk | FTP | other *** search
/ Aminet 16 / Aminet 16 (1996)(GTI - Schatztruhe)[!][Dec 1996].iso / Aminet / gfx / misc / xipaintmodul52.readme < prev   
Text File  |  1996-11-04  |  11KB  |  220 lines

  1. Short:    Univ. loader&anim.saver for XiPaint
  2. Author:   hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann)
  3. Uploader: hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann)
  4. Type:     gfx/misc
  5. Kurz:     XiPaint-Universal-Lader&Animationssp.Modul
  6.  
  7. HHsFastUniversalXiPaintModule 5.2 (incl. PhotoCD- & TrueColorAnim-support)
  8. =================================
  9.  
  10. New: Registered module users can now order my new programs "PhotoAlbum"
  11.      or the package of "PhotoAlbum" and "CyberShow Professional" for special
  12.      sidegrade prices! See PhotoAlbum documentation for details...
  13.      Both programs are usable on all Amigas with at least OS3.0.
  14.  
  15. new in V5.2: Support for 15Bit IFF-ILBM images
  16.  
  17. new in V5.1: Extended DEEP loading functions (to be compatible with
  18.                new variants as created e.g. by TVPaint 3)
  19.  
  20. new in V5.0: Loading support for progressive JPeg files
  21.              Documentation in Amiga Guide format
  22.                
  23. new in V4.x: Downscaled loading support: Loading big pictures in downscaled
  24.         form can save much memory and time. Finally a way to get
  25.         your "too big" pictures into XiPaint...
  26.     Included JPeg support (esp. useful e.g. for downscaled loading)
  27.     Automatic installation script added.
  28. new in V3.0: TrueColor animation saving support in HHsYUVSq animation format
  29.     ->create your own TrueColor animations for playback on CyberGraphX
  30.       with CyberTVPlayer or on EGS with EGSTVPlayer <-
  31.     Including ARexx script for automatic conversion of picture
  32.       directories into HHsYUVSq animation format
  33.  
  34. This universal module can be used to load images in many file formats
  35. (more than 20 and additionally Datatypes) very fast into XiPaint (including
  36. optional downscaling) and to create TrueColor animations in HHsYUVSq
  37. animation format.
  38.  
  39. Warning: I am aware that illegal/modified keyfiles of this module may exist.
  40. !Use of such keyfiles ("hhsxipaintmodkey.library") is strictly prohibited and
  41. !can lead to undefined results and problems! For a program which you use
  42. !you should also be willing to pay the shareware fee. Only if enough users
  43. !register I will be able to do further improvements or create other graphic
  44. !applications. You can also help me by sending me illegal keyfiles of
  45. !this product which you find somewhere.
  46.  
  47. Supported file formats
  48. ----------------------
  49.  
  50. Supported file formats for loading:
  51.  
  52. * IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 15Bit, 24Bit)
  53. * JPeg (color and greyscale; see notes below)
  54. * PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit colors)
  55. * PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  56. * QRT (also known as dump format by PD raytracers as POV-Ray)
  57. * Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit;incl. interleaved)
  58. * PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  59. * MacPaint (b&w compressed 1Bit format; datafork only)
  60. * BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
  61. * TIF (packbit-compr.&uncompr. 24Bit,1-8Bit grey/Color Motorola&Intel formats)
  62. * EGS7.x window iconification file format
  63. * DEEP (compr.&uncompr. 24Bit and 32Bit)
  64. * RGB formats (RGB8, RGBN, RGB5)
  65. * ACBM formats (1 to 8Bit, incl. HAM6/HAM8)
  66. * FBM formats (8Bit grey/color and 24Bit)
  67. * IFF-PBM (DPII) format
  68. * Sun raster (1Bit, 8Bit grey/color and 24Bit uncompressed)
  69. * YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  70. * VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  71. * HHsYUVSq sequence format (sequential or random access; only first frame)
  72. * HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  73. * binary-EPS bitmaps (RGB and CMYK; this function is experimental)
  74. * TBCPlus frames&fields
  75.  
  76. * DataType (incl. first frame of animations with Anim-Datatypes)
  77.  
  78. Supported file formats for saving:
  79.  
  80. * HHsYUVSq animation format
  81.  
  82. Automatic creation of HHsYUVSq TrueColor animations
  83. ---------------------------------------------------
  84.  
  85. With the script "makeanim.rx" you can automatically convert a directory
  86. of pictures into an HHsYUVSq animation file. Just start the script
  87. from XiPaint as macro or from Workbench or Shell. It should work with
  88. all XiPaint 3.x and up versions. If you start it from XiPaint, you will
  89. probably have to switch to WB screen manually; there you get a requester
  90. asking for the source directory which should contain the pictures
  91. (all of the same size). Then you are asked for the destination animation
  92. file. Then the automatic conversion is started. Pictures are downscaled
  93. if necessary. You can watch the pictures beeing loaded in XiPaint. They
  94. are loaded in alphabetical order (users of old XiPaint versions prior to
  95. V3.2 should NOT play with XiPaint during this process as this can
  96. block the whole system). With newer versions it should be save to
  97. use XiPaint for other things during the process except loading as
  98. this would interact with the frame loading! If the conversion has finished,
  99. the last picture will remain in XiPaint as a project. You can close
  100. this manually.
  101.  
  102. To play the animations use my freeware player programs
  103. CyberTVPlayer for TrueColor playback on CyberGraphX compatible
  104. boards (incl. Draco) or EGSTVPlayer for TrueColor playback on
  105. EGS compatible boards. CyberTVPlayer can also be used without
  106. CyberGraphX for reduced viewing (upto 256 colors) on all Amigas
  107. with at least OS3.0.
  108.  
  109. Additional notes: The loading/saving is done with HHsXiPaintMod.xio
  110. only; so you can only load pictures in one of the supported formats
  111. (see above). If you want to make animations from pictures in other formats,
  112. you have to load and save them with the appropriate modules manually.
  113. But anyway, the module now seems to support nearly all formats...
  114.  
  115. Downscaled loading
  116. ------------------
  117.  
  118. The loader module now supports direct downscaled loading in XiPaint 3.2
  119. and higher; simply select the appropriate loader version in the list.
  120. Currently the loader should appear 3 times: HHsUniversalLoader for full
  121. size, Universal_50%_Size for half size and Universal_25%_Size for quarter
  122. size. For most file formats (e.g. IFF, DEEP, JPeg, PCX, PPM, Targa, ...)
  123. the downscaling is done on a line by line base, so that memory will only
  124. be needed for the reduced size. This should enable you to get big
  125. pictures into XiPaint without memory problems.
  126.  
  127. General notes
  128. -------------
  129.  
  130. There are currently no error requesters for loading (if a file can not be
  131. loaded nothing will happen). For saving error requesters are included.
  132.  
  133. If you register for the XiPaint modules you will receive a
  134. keyfile together with the latest version of the modules. The
  135. keyfile will enable you to use future demo versions as update.
  136.  
  137. The demo version will load and save all pictures in greyscales, but
  138. usually at the same speed as the full version would do in color.
  139.  
  140. XiPaintModules need at least OS2.04 (OS3.x for Datatype usage).
  141.  
  142. All loading functions (except JPeg: This software is based in part on the work
  143. of the independent JPeg Group) have been written in Assembler and optimised for
  144. extremely high speed. An exception to this is the JPeg format, which is
  145. written in C and based on the usual code of the indipendent JPeg group.
  146. I created the fast loading functions mainly for my famous shareware programs
  147. *** CyberShow Professional *** (universal viewer and slideshow program
  148. for all OS3.x Amigas and Dracos and esp. for CyberGraphX users), EGSPhotoAlbum
  149. Prof. and EGS-TV Prof.; When new formats are implemented for my other
  150. programs (or the speed is improved further), I will usually also update
  151. the modules, which registered user can then use due to the keyfile concept.
  152.  
  153. The JPeg format has been included in this module mainly for the comfort
  154. of the users (as otherwise for JPeg another loader module would have to
  155. be seleted) and to enable JPeg loading in downscaled form, which can be
  156. very useful. Now you can also create animations in HHsYUVSq animation
  157. format from JPeg pictures with the automatic ARexx script. The loading
  158. speed of the JPeg code (for pictures in full size) is unfortunately
  159. currently not very fast. Downscaled loading of JPeg can be much faster.
  160.  
  161. Registration
  162. ------------
  163.  
  164. You can register for the module at the small add-on price of only 8US$ or
  165. 10DM if you order it together with one of my other shareware programs,
  166. e.g. CyberShow, the universal viewer and slideshow program for all Amigas
  167. with at least OS3.0 (loading the same formats as the XiPaintModule)
  168. or EGSPhotoAlbum or EGS-TV. Please use the registration forms of thoose
  169. programs and specify your add-on module order there and include the
  170. extra amount.
  171.  
  172. Otherwise you should use the included registration form to register:
  173.  
  174. If you only want to register for the module, the registration fee is
  175. 18US$ outside europe or 20DM in europe. You will also get the latest demo
  176. versions of my other programs. Additional modules (e.g. UniversalGIO for
  177. Photogenics or FastIFXModules for ImageFX) can be ordered at the lower
  178. add-on price.
  179.  
  180. If you are already a registered user of one of my programs and now want to
  181. register for the modules, the registration fee is 13US$ outside europe or
  182. 15DM (in europe). Additional modules (e.g. UniversalGIO for Photogenics or
  183. FastIFXModules for ImageFX) can be ordered at the lower add-on price.
  184.  
  185. (Special note for users in germany only: Wenn Sie schon registrierter Benutzer
  186.  eines meiner Shareware-Programme sind und sich Ihre Anschrift nicht
  187.  geändert hat, können Sie die Module direkt per Überweisung bestellen.
  188.  Als Verwendungszweck geben Sie bitte "XiPaintMod für ...." an, wobei Sie
  189.  das Programm was Sie schon haben und die Registriernummer angeben.
  190.  Zusätzlich möglichst auch noch Name/Anschrift; die Bankverbindung:
  191.  Konto-Nr. 5740147 BLZ 310 500 00 Stadtspark. Mönchengladbach)
  192.  (No bank transfers from outside germany!)
  193.  
  194. Send your filled in registration form together with cheque, international
  195. postal money order or banknotes to:
  196.  
  197.     Helmut Hoffmann
  198.     Rubensstrasse 4
  199.     D-41063 Moenchengladbach
  200.     Germany
  201.  
  202.  
  203. ============================= Archive contents =============================
  204.  
  205. Original  Packed Ratio    Date     Time    Name
  206. -------- ------- ----- --------- --------  -------------
  207.      628     270 57.0% 08-Feb-96 17:12:00  XiPaintModule.info
  208.      884     372 57.9% 11-Dec-95 00:17:48 +hhsxipaintloader.rx
  209.    85840   41021 52.2% 23-Oct-96 01:47:40 +hhsxipaintmod.xio
  210.     1254     465 62.9% 09-Feb-96 00:47:34 +Install
  211.      466     132 71.6% 08-Feb-96 17:11:46 +Install.info
  212.     2168     872 59.7% 08-Feb-96 19:21:04 +makeanim.rx
  213.      461     177 61.6% 08-Feb-96 17:11:46 +makeanim.rx.info
  214.     2454    1113 54.6% 23-Oct-96 02:01:14 +registration.txt
  215.      477     248 48.0% 08-Feb-96 17:11:46 +registration.txt.info
  216.    25200    9730 61.3% 23-Oct-96 01:52:46 +XiPaintModule.guide
  217.      482     256 46.8% 30-May-96 03:46:28 +XiPaintModule.guide.info
  218. -------- ------- ----- --------- --------
  219.   120314   54656 54.5% 24-Oct-96 00:29:20   11 files
  220.